home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmIsTraversable.z / XmIsTraversable
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee - A function that identifies whether a
  10.           widget can be traversed
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt);
  16.  
  17.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  18.           This page documents Motif 2.1.
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.           XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee determines whether the specified widget is
  22.           eligible to receive focus through keyboard traversal.  In
  23.           general, a widget is eligible to receive focus when all of
  24.           the following conditions are true:
  25.  
  26.              +o  The widget and its ancestors are not being destroyed,
  27.                 are sensitive, and have a value of True for
  28.                 XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn.
  29.  
  30.              +o  The widget and its ancestors are realized, managed,
  31.                 and (except for gadgets) mapped.  If an application
  32.                 unmaps a _w_i_d_g_e_t that has its XXXXmmmmNNNNmmmmaaaappppppppeeeeddddWWWWhhhheeeennnnMMMMaaaannnnaaaaggggeeeedddd
  33.                 resource set to True, the return value is undefined.
  34.  
  35.              +o  Some part of the widget's rectangular area is
  36.                 unobscured by the widget's ancestors, or some part of
  37.                 the widget's rectangular area is inside the work
  38.                 window (but possibly outside the clip window) of a
  39.                 ScrolledWindow whose XXXXmmmmNNNNssssccccrrrroooolllllllliiiinnnnggggPPPPoooolllliiiiccccyyyy is XXXXmmmmAAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC
  40.                 and whose XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrsssseeeeOOOObbbbssssccccuuuurrrreeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is not NULL.
  41.  
  42.           Some widgets may not be eligible to receive focus even if
  43.           they meet all these conditions.  For example, most managers
  44.           cannot receive focus through keyboard traversal.  Some
  45.           widgets may be eligible to receive focus under particular
  46.           conditions.  For example, a DrawingArea is eligible to
  47.           receive focus if it meets the conditions above and has no
  48.           child whose XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn resource is True.
  49.  
  50.           Note that when all widgets in a shell hierarchy have been
  51.           made untraversable, they are considered to have lost focus.
  52.           When a widget in this hierarchy is made traversable again,
  53.           it regains focus.
  54.  
  55.           XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee may return unexpected results when _w_i_d_g_e_tor
  56.           its ancestors are overlapped by their siblings.
  57.  
  58.           _w_i_d_g_e_t    Specifies the ID of the widget
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEETTTTUUUURRRRNNNN
  75.           Returns True if the widget is eligible to receive focus
  76.           through keyboard traversal; otherwise, returns False.
  77.  
  78.      RRRREEEELLLLAAAATTTTEEEEDDDD
  79.           XXXXmmmmGGGGeeeettttVVVViiiissssiiiibbbbiiiilllliiiittttyyyy(3) and XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll(3).
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.